home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / pv43.zip / VAULT.DOC < prev    next >
Text File  |  1992-05-25  |  14KB  |  321 lines
  1.  
  2.                        ============================
  3.                              THE PRIZE VAULT
  4.                        ============================
  5.  
  6.         One of the T&J Software Collection of multi-BBS door programs.
  7.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  8.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  9.  
  10.                        VERSION 4.30     05/25/92
  11.  
  12.                                    By
  13.  
  14.                                Tom Wildoner
  15.                              397 West Broadway
  16.                               Jim Thorpe, PA
  17.                                   18229
  18.  
  19.                                    From
  20.  
  21.                                   T&J BBS
  22.                                (717)325-9481
  23.                         1200/2400/9600/19200/38400
  24.                                24 Hours/Day
  25.  
  26.  
  27. LATEST VERSION:
  28. ===============
  29. Please call the T&J BBS for the latest version of this program.
  30.  
  31. DISTRIBUTION:
  32. =============
  33. You may make this file available for downloading from your BBS or you may
  34. upload it to any BBS of your choice, provided that you do not make any
  35. changes to the contents of the archive (ZIP file). The archive and its
  36. individual contents may not be used by any service that charges any money
  37. whatsoever, without the written permission of the author.
  38.  
  39. LEGALITIES:
  40. ===========
  41.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  42.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  43.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  44.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  45.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  46.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  47.       OR BREACH OF ANY WARRANTY.
  48.  
  49. FEATURES:
  50. =========
  51.            --- Return to BBS on dropped carrier.
  52.            --- 4-minutes no activity will return to BBS.
  53.            --- Online Chat.
  54.            --- You can blank the display.
  55.            --- Dump user back to BBS.
  56.            --- Drop to DOS function.
  57.            --- Desqview Aware.
  58.            --- COM1-4 support and non-standard IRQ's.
  59.            --- Colorful ANSI screens.
  60.            --- NO BRUN module needed for play.
  61.            --- BETA tested on five different boards.
  62.            --- Use of HOT KEYS while in the door.
  63.            --- Handy statistics presented to user on door usage.
  64.            --- Support BBS available.
  65.  
  66.  
  67. PROGRAM DESCRIPTION:
  68. ====================
  69. Prize Vault is a simple door program which allows callers to try and
  70. guess the combination of the vault. If they successfully guess the
  71. combination, they win the listed prize. I usually enter a prize such
  72. as 500 fighters in Trade Wars, etc...  Other SYSOP's enter such things
  73. as "a free large pizza...", not a bad idea! What about those long
  74. distance callers! <grin>
  75.  
  76. If the door is UNREGISTERED, your users will only be permitted to
  77. enter the door once per day and will be limited to 5 guesses only.
  78.  
  79. Prize Vault will not allow any one else to guess at the combination
  80. once somebody has won. It is up to the SYSOP to reset the combination
  81. and prize after a win.
  82.  
  83. Another item that was added are four "bar charts" to the right of
  84. the screen. These bars will help users determine if they are getting
  85. NEAR the number or FAR away. Thus, you can use bigger numbers
  86. for the combination.
  87.  
  88. There are four numbers to the combination and they can range from
  89. 1 to 999,999,999! You are limited to 9 digits.
  90.  
  91.  
  92. CONFIGURATION:
  93. =============
  94.  
  95. Example configuration file for PCBOARD.SYS
  96. ------------------------------------------
  97.  
  98. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  99. T&J Software        <=-  (Change this to your BBS name)
  100. Tom                 <=-  (The Sysop's first name)
  101. Wildoner            <=-  (The Sysop's last name)
  102.  
  103. Example configuration file for USERS.SYS
  104. ----------------------------------------
  105.  
  106. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  107. T&J Software        <=-  (Change this to your BBS name)
  108. Tom                 <=-  (The Sysop's first name)
  109. Wildoner            <=-  (The Sysop's last name)
  110.  
  111. Example configuration file for DOOR.SYS
  112. ---------------------------------------
  113.  
  114. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  115. T&J Software        <=-  (Change this to your BBS name)
  116. Tom                 <=-  (The Sysop's first name)
  117. Wildoner            <=-  (The Sysop's last name)
  118.  
  119. Example configuration file for USERINFO.DAT
  120. -------------------------------------------
  121.  
  122. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  123. T&J Software        <=-  (Change this to your BBS name)
  124. Tom                 <=-  (The Sysop's first name)
  125. Wildoner            <=-  (The Sysop's last name)
  126. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  127.  
  128. Example configuration file for CALLINFO.BBS
  129. -------------------------------------------
  130.  
  131. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  132. T&J Software        <=-  (Change this to your BBS name)
  133. Tom                 <=-  (The Sysop's first name)
  134. Wildoner            <=-  (The Sysop's last name)
  135.  
  136. Example configuration file for DORINFOx.DEF
  137. -------------------------------------------
  138.  
  139. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  140.                           where 'x' is the BBS Node number.
  141. T&J Software        <=-  (Change this to your BBS name)
  142. Tom                 <=-  (The Sysop's first name)
  143. Wildoner            <=-  (The Sysop's last name)
  144.  
  145. Example configuration file for SFDOORS.DAT
  146. ------------------------------------------
  147.  
  148. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  149. T&J Software        <=-  (Change this to your BBS name)
  150. Tom                 <=-  (The Sysop's first name)
  151. Wildoner            <=-  (The Sysop's last name)
  152.  
  153. Example configuration file for CHAIN.TXT
  154. ----------------------------------------
  155.  
  156. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  157. T&J Software        <=-  (Change this to your BBS name)
  158. Tom                 <=-  (The Sysop's first name)
  159. Wildoner            <=-  (The Sysop's last name)
  160.  
  161. Example configuration file for GTUSER.BBS
  162. -----------------------------------------
  163.  
  164. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  165. T&J Software        <=-  (Change this to your BBS name)
  166. Tom                 <=-  (The Sysop's first name)
  167. Wildoner            <=-  (The Sysop's last name)
  168. 1                   <=-  (COM port number - defaults to 1)
  169. 1                   <=-  (Node number - defaults to 1)
  170.  
  171. Example Batch File
  172. ==================
  173.  
  174. A sample batch file is included and is similer to the following:
  175.    ECHO OFF
  176.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  177.    PV43 VAULT.CFG           <=- Execute the door program and pass the
  178.                                 configuration filename to the program.
  179.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  180.    BOARD                    <=- Restart BBS.
  181.  
  182. This Door is multi-node  compatible so you may run more than 1 node from
  183. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  184. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  185. variables, (q.v.)
  186.  
  187. Environment Variables
  188. =====================
  189.  
  190. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  191. variables. Non-PCBoard systems may also use these variables by including
  192. the following in either your BBS batch or AUTOEXEC.BAT
  193.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  194.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  195. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  196. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  197. .CFG file for multi-node operation!
  198.  
  199. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  200. command line.  For example:
  201.  
  202.      PV43 VAULT.CFG /5
  203. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  204.      PV43 VAULT.CFG /%IRQ%
  205.  
  206. This tells the program to use IRQ 5 instead of the standard IRQ.
  207.  
  208.  
  209. Sysop Keys
  210. ==========
  211.  
  212. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  213.          written to DOOR.SYS and USERS.SYS
  214. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  215.          and/or written to DOOR.SYS and USERS.SYS
  216. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  217. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  218.          and/or written to DOOR.SYS and USERS.SYS
  219. F8    -  Returns the caller involuntarily to the BBS.
  220. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  221.          and/or written to DOOR.SYS and USERS.SYS
  222. F10   -  Activates SysOp CHAT mode within the DOOR.
  223. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  224. UP    -  Give the caller extra time while in the DOOR.  
  225. DN    -  Subtract time from the caller while in the DOOR. 
  226. HOME  -  HELP key for Status Line options.
  227. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  228. ALT-X -  PCBoard will exit after current caller logs off. Value is
  229.          passed to PCBoard. Not available on non-PCBoard systems.
  230.  
  231.  
  232. SYSOP.CFG contains the following information:
  233.  
  234. C:\WC30\BULL\bull6.scr       'PATH to color bulletin.
  235. C:\WC30\BULL\bull6.bbs       'PATH to ASCII bulletin.
  236. 4987102                      '1st combination number.
  237. 38902                        '2nd combination number.
  238. 678208                       '3rd combination number.
  239. 2340870                      '4th combination number.
  240. The PRIZE VAULT currently contains a FREE            'PRIZE description
  241. GAME PACK to the cracker of the vault! This          'PRIZE description
  242. is normally a $50 package!                           'PRIZE description
  243.                                                      'PRIZE description
  244.                                                      'PRIZE description
  245.                                                      'PRIZE description
  246.                                                      'PRIZE description
  247.                              'Was the vault cracked YES or NO
  248.                              'Who cracked the vault
  249.                              'DATE the vault was cracked
  250. TOM WILDONER                 'Last user of the door
  251. 5000000                      'Your HIGH number
  252. 02-29-1992                   'Date Prize Vault was reset
  253. 50                           'Number of attempts/play
  254. 2                            'Number of plays/day
  255.  
  256. Running PV43 with the command string SETUP (i.e. PV43 SETUP) will help
  257. you setup your PATH to the bulletins, reset the combination, and reset
  258. the door statistics. Running the SETUP program will be the easiest way
  259. to get the door running. But, if you wish to use your favorite text editor,
  260. here are a few hints:
  261.  
  262.   --- Your SYSOP.CFG file must have all 21 lines.
  263.   --- Your prize description is allowed 7 lines, each line
  264.       cannot exceed 45 characters.
  265.  
  266. INITIAL SETUP OF BULLETINS:
  267. ==========================
  268.  
  269. Prize Vault only creates a bulletin when there is a winner. Sometimes this
  270. will take some time to accomplish! I have included two bulletins which
  271. you can place in your bulletin directory until you have your first winner.
  272. They are WINNER.SCR (color bulletin) and WINNER.BBS (mono bulletin). Just
  273. rename them and copy them into your bulletin directory. They simply state
  274. that nobody has cracked the combination yet.
  275.  
  276.  
  277. FUTURE VERSIONS:
  278. ================
  279. What would you like to see added?
  280.  
  281. VERSION HISTORY:
  282. ================
  283. Version 0.10 BETA..... concept designed and written.
  284. Version 0.30 BETA..... BETA release made public as FREEWARE.
  285. Version 1.00 ......... Corrected bugs in the LINE 25 SYSOP screen.
  286. Version 1.20 ......... Added a new opening screen.
  287.                        Add some "beeps" to the remote location.
  288.                        Cleaned up the code a little.
  289. Version 2.00 ......... Registration required for this version.
  290.                        MAJOR improvements to screens & code.
  291.                        Added a mono LOG file.
  292. Version 2.20 ......... Added a color and mono LOG file.
  293.                        Added a color and mono WINNER's screen.
  294.                        Added the ability to limit the user by the number
  295.                        of tries instead of time.
  296.                        Revised VAULTRES.EXE and VM.EXE to handle the
  297.                        new COMB.DAT format.
  298. Version 3.00 ......... All external files placed within the new code.
  299.                        Now using BASIC PDS v7.1 for the program. Internal
  300.                        bulletin generation. Added new KEY file approach,
  301.                        your KEY will unlock the full version of this and
  302.                        future releases.
  303. Version 3.01 ......... Minor bug fix -- winner announcement.
  304. Version 3.10 ......... Fix for unlocked com ports.
  305. Version 4.00 ......... Basically a complete re-write of the door,
  306.                        switched to new door routines.
  307. Version 4.10 ......... Fixed problem with OVERFLOW error. Limit numbers
  308.                        to 9 digits (i.e. 0 to 999,999,999).
  309. Version 4.20 ......... Problem fixed with PV overwriting your first
  310.                        digit of the combination.
  311. Version 4.30 ......... Updated to the newest door routines. Included the
  312.                        old PVEXTRA.EXE program as part of the main code
  313.                        using the command line SETUP.
  314.  
  315.  
  316. That's all there is to it! If you have any problems or questions
  317. please feel free to call the T&J BBS at (717)325-9481.
  318.  
  319.  
  320. See the REGISTER.TXT for information on registering.
  321.